<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>imat_wav_read</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="LIBIT Documentation"
HREF="index.html"><LINK
REL="UP"
HREF="refmanual.html"><LINK
REL="PREVIOUS"
TITLE="mat_wav_read"
HREF="man.mat-wav-read.html"><LINK
REL="NEXT"
TITLE="mat_wav_write"
HREF="man.mat-wav-write.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>LIBIT Documentation</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="man.mat-wav-read.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="man.mat-wav-write.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="MAN.IMAT-WAV-READ"
></A
>imat_wav_read</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN1261"
></A
><H2
>Name</H2
>imat_wav_read&nbsp;--&nbsp;Read a wav file into a multi-channel matrix</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN1264"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><A
NAME="AEN1265"
></A
><PRE
CLASS="FUNCSYNOPSISINFO"
>#include &lt;it/io.h&gt;
      </PRE
><P
><CODE
><CODE
CLASS="FUNCDEF"
>imat imat_wav_read</CODE
>( const char* filename
        );</CODE
></P
><P
></P
></DIV
></DIV
><H2
>DESCRIPTION</H2
><P
> The function <CODE
CLASS="FUNCTION"
>imat_wav_read</CODE
> reads a WAV file named <CODE
CLASS="PARAMETER"
>filename</CODE
> and returns a matrix of integers. Each row of this matrix corresponds to a channel in the WAV file. For example, a mono WAV file will result in a matrix with one row, whereas a stereo WAV file will result in a matrix with two rows. Each row is a vector representing the samples of the sound for each instant. The number of bits used to represent each sample and sampling frequency depend on the actual WAV file and can be retrieved via <CODE
CLASS="FUNCTION"
>wav_info</CODE
>.  </P
><H2
>RETURN VALUE</H2
><P
>    The matrix containing a row per channel
   </P
><H2
>EXAMPLE</H2
><PRE
CLASS="PROGRAMLISTING"
>&#13;#include &lt;io.h&gt;

...

imat m;
m = imat_wav_read("sound.wav");</PRE
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="man.mat-wav-read.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="man.mat-wav-write.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>mat_wav_read</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="refmanual.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>mat_wav_write</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>